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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part 4 of a multi-part TS covering the Telecommunication Management; Fault Management; 
Part 4: Alarm Integration Reference Point: CMIP solution set, as identifies below: 

Part 1: "3G Fault Management Requirements"; 

Part 2: "Alarm Integration Reference Point: Information Service Version 1"; 

Part 3: "Alarm Integration Reference Point: CORBA Solution Set version 1:1"; 

Part 4: "Alarm Integration Reference Point: CMIP Solution Set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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1 Scope 

The present document defines the alarm integration reference point for the CMIP solution set. In detail: 
clause 4 contains an introduction to some basic concepts of the CMIP interfaces; 
clause 5 contains the GDMO definitions for the Alarm Management over the CMIP interfaces; 
clause 6 contains the ASN. 1 definitions supporting the GDMO definitions provided in clause 5. 

2 References 

The following documents contain provisions, which through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.302: "Telecommunication Management; Configuration Management; Notification 
Integration Reference Point; Information Service version 1 Point: Information Service". 

[2] ITU-T Recommendation X.710: "Information technology - Open Systems Interconnection - 

Common Management Information Service". 

[3] ITU-T Recommendation X.711: "Information technology - Open Systems Interconnection - 

Common Management Information Protocol: Specification". 

[4] ITU-T Recommendation X.721: "Information technology - Open Systems Interconnection - 

Structure of management information: Definition of management information". 

[5] ITU-T Recommendation X.733: "Information technology - Open Systems Interconnection - 

Systems Management: Alarm reporting function". 

[6] ITU-T Recommendation X.734: "Information technology - Open Systems Interconnection - 

Systems Management: Event report management function". 

[7] ITU-T Recommendation Q.821: "Stage 2 and Stage 3 description for the Q3 interface - Alarm 

Surveillance". 

[8] 3GPP TS 32. Ill - 1 : "Telecommunication Management; Fault Management; Part 1 : 3G Fault 

management requirements". 

[9] 3GPP TS 32. Ill -2: "Telecommunication Management; Fault Management; Part 2: Alarm 

Integration Reference Point: Information Service Version 1". 

[10] 3GPP TS 32.304: "Telecommunication Management; Configuration Management; Notification 

Integration Reference Point: CMIP Solution Set Version 1:1". 

[II] 3GPP TS 32.312: "Telecommunication management; Generic IRP Management: 
InformationService" . 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions defined in 3GPP TS 32. 1 1 1-1 [8] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

ASN. 1 Abstract Syntax Notation number 1 

CCITT The International Telegraph and Telephone Consultative Committee 

CM Configuration Management 

CMIP Common Management Information Protocol 

CMIS Common Management Information Service 

CMISE Common Management Information Service Element 

EFD Event Forwarding Discriminator 

EM Element Manager 

FT AM File Transfer Access and Management 

GDMO Guidelines for the Defifition of Managed Objects 

IOC Information Object Class 

IRP Integration Reference Point 

Itf-N Interface N (between NM and EM/NE) 

ITU-T International Telecommunication Union - Telecommunications 

M Mandatory 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

NM Network Manager 

NMC Network Management Centre 

O Optional 

OS Operations System 

TMN Telecommunications Management Network 



Basic aspects 



The present document provides all the GDMO and ASN. 1 definitions necessary to implement the Alarm IRP 
Information Service [9] for the CMIP interface. The Alarm IRP Information Service description is based on Information 
Object Classes (IOC), Relationships among IOC and Interfaces (used or implemented by IOC) which include 
Operations and/or Notifications. 

In the present document, for the CMIP interfaces the IOC are modeled as GDMO "Managed Object Classes" (MOC) 
defined specifically for alarm management, the Operations are modeled as GDMO "Actions" of a MOC while the 
Notifications are modeled as GDMO "Notifications" included in MOCs that need to report events to the Manager. In 
more detail, the Notifications related to alarm management are included in a MOC defined in the present document 
while the Notifications defined for alarm reporting are not included in any MOC defined in the present document. They 
will be included in other MOCs defined in other CMIP Solution Set or in other CMIP Information Models. 

Regarding the Notifications, the present document is based on the Notification IRP CMIP Solution Set 
(3GPPTS 32.304 [10]). 

4.1 Reporting new alarms 

In case of an alarm occurrence the Agent notifies all subscribed Managers that a new alarm has occurred and has been 
added into the alarm list of the Agent. 

For this purpose the standardised alarm notifications defined in [4] and [5] are used. 
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4.2 Reporting changed alarms 



Although in the Alarm IRP Information Service [9] there is a notification specifically defined to report the event of 
alarm attribute changes, on the CMIP interfaces such events are reported according to [4] and [5], i.e. the original alarm 
is first cleared (by means of a clear alarm notification ) and then a new alarm notification with the changed parameter 
values is generated by the Agent. 



4.3 Reporting cleared alarms 



On the CMIP interfaces the clearing of alarms is reported by the Agent to the Managers in accordance with the 
mechanisms defined in ITU-T Recommendation X.733 [5] and ITU-T Recommendation Q.821 [7]. 

4.4 Acknowledgment of alarms 

This clause relates to the co-operative alarm acknowledgment managed on Itf-N, which implies that the 
acknowledgment of alarms can be done on both NM and EM. 

The acknowledgment of alarms is managed by means of the MOC alarmControl, which includes: 

One Action to acknowledge alarms; 

One Action to unacknowledge alarms; 

ITU-T Recommendation X.721 [4] compliant Alarm Notification to inform Managers about changes of 
acknowledgment state. 

In case an alarm is acknowledged by an operator or automatically by a management system, the ackUser Id, 
ackSystemId, ackState and ackTime information is stored in the additionallnformation field of the alarm 
present in the alarm list. 

4.5 Management of comments associated to alarms 

This feature provides the Operators with the capability to add comments to an alarm and to share such information 
among all the OS (EM and NM) that are involved in the network management. An OS shall have the capability to 
record more than one comment for each alarm. 

The management of the comments associated to alarms is similar to the management of the acknowledgment of alarms 
and is achieved by means of the same MOC alarmControl. For the management of the comments, the MOC 
alarmControl includes one Action to set the comment and Notification to distribute the comments to other OS. 

4.6 Alignment of alarm conditions over the Itf-N 

The IRP Manager is able to trigger the alarm conditions alignment using the Action getAlarniList 

The following specifies the logical steps of the alignment procedure, by describing a possible implementation. Any 
other implementation showing the same behaviour on the Itf-N interface is compliant with the present document. 

The Manager sends to the Agent a getAlarniList request containing the following information: 

alarniAckState, used to select the alarms from the Agent's alarm list for the current alignment (e.g. all active 
alarms). 

destination, identifying the destination to which event reports that have passed the filter conditions are sent. 

- fdter, this optional parameter defines the conditions an alarm notification shall fulfil in order to be forwarded 
to the Manager. It applies only for the current alignment request. 

After evaluation of the request, the Agent first generates an alignmentld value, which unambiguously identifies 
this alignment process. This value is used by the Manager to correlate alarm reports to the corresponding 
alignment requests, in case this Manager issues several alarm alignments in parallel. 
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The Agent creates a temporary Event Forwarding Discriminator (EFD) instance for the purpose of this alarm 

alignment, using the parameters destination and /i/fer received in the request. If the /iZfer parameter is absent 

or NULL, all alarm notifications are forwarded to the Manager through this EFD, according to the value of 

the parameter alarniAckState. 

The filter is set by the Agent automatically in order to forward to only those alarm notifications containing, at 

the beginning of the field additionalText, either the string "(ALIGNMENT-<alignmentId>)" or the string 

"(ALIGNMENTEND-<alignmentId>)". 

The Agent sends back a getAlarniList response, which contains the alignmentld described above and the status 
information, indicating the result of the request, (see the message flow in Figure 1). 

The Agent scans now its alarm list. For every alarm, which matches the criteria defined by the alarniAckState 
parameter, the Agent inserts, at the beginning of the field additionalText, the string "(ALIGNMENT- 
<alignmentld>)". According to ITU-T Recommendation X.734 [6], the Agent forwards these alarm notifications 
towards all EFDs. 

In the last alarm of the list the Agent inserts the string "(ALIGNMENTEND-<alignmentId>)" to indicate the end 
of the alarm alignment. 

NOTE: These alarm notifications can reach the current Manager only via the temporary EFD created for the 
current alignment. They are filtered out: 

a) By all the EFD instances used for "real-time" alarm reporting, due to the presence of the sub-string 
"ALIGNMENT" in the field additionalText (see 3GPP TS 32.304 [10]). 

b) By all temporary EFD instances possibly created for parallel alignments, due to the presence of the 
unambiguous sub-string "<alignmentld>" in the additionalText field. 

After sending the last alarm report (identified by the sub-string " ALIGNMENTEND" in the additionalText), the 
Agent automatically deletes the temporary EFD instance (see figure 1). 



Manager 



M-ACTION request: getAlarmList 

(alarmAckState, destination, 

M-ACTION response: petAlarmList 



(alignmentld, 

M-EVENT-REPORT: alarm report 1 

additionalText 4ALIGNMEWalignmentld 



M-EVENT-REPORT: alarm report 2 

additionalText =(ALIGNMEh4-allgnmentld 



Agent 



M-EVENT-REPORT: alarm report 

(... , additionalText.^:..", ..) 



M-EVENT-REPORTa/arm report n 

.., additionalText =(ALIGNMENTENalignmentld... ', 



The Agent creates a temporary EFD 



This is a real-time alarm, forwarded by 
the Agent during alarm alignment 



Last alarm (from the Agent's alarm list) 
which matches the required criteria. 

The Agent deletes automatically the 
temporary 



Figure 1 : Alignment arrow diagram 
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Figure 2 shows the handling of a "real-time" alarm notification (occured during the execution of the getAlarniList 
operation), which is forwarded by the Agent (according to ITU-T Recommendation X.734 [6]) to all currently available 
EFD instances. Dependent on the discriminatorConstruct setting of every EFD, such an alarm may or may not reach the 
related Manager. In any case, this alarm is filtered out by the temporary EFD assigned to the Manager, which triggered 
the getAlarniList request. 



Current 
Manager 

-* 



Manager 




"Real-time" alarm 
notification 



Figure 2: Treatment of "real time" alarms 

Figure 3 shows the handling of an alarm notification from the alarm list, matching the criteria defined in the parameters 
alarniAckState of the getAlarniList request and forwarded by the Agent to all EFD instances as well. This alarm is 
filtered out by all EFD instances in charge of discrimination of "real-time" alarms and can reach only the Manager, 
which triggered the getAlarniList request, because it passes the temporary EFD instance assigned to this Manager. 



£75/ 



3GPP TS 32.111-4 version 4.0.0 Release 4 



11 



ETSI TS 132 111-4 V4.0.0 (2001-09) 



Current 
Manager 



Manager 



Itf-N 




Alarm 
filtered out 



Alarm notification 
from Alarm List 



Agent 



Figure 3: Treatment of "alignent" alarms 



4.7 



Mapping 



The semantics of the Alarm IRP is defined in 3GPP TS 32.111-2 [9]. The definitions of the management information 
defined there are independent of any implementation technology and protocol. This clause maps these protocol- 
independent definitions onto the equivalences of the CMIP solution set of Alarm IRP. 

4.7.1 Mapping of IOC and Interfaces 

For this Alarm IRP CMIP Solution Sets, the Information Object Classes (IOC) and the Interfaces defined in 

TS 32.111-2 [9] are mapped to a Managed Object Classes (MOC) named alarmControl which includes all the 

Attributes, Actions and Notifications necessary to model the management described in [9]. 

4.7.2 IVIapping of Interface/Operations 

Table 1 maps the Interface/Operations defined in the IS of the Alarm IRP to their equivalents in the CMIP SS. The 
equivalents are qualified as Mandatory (M) or Optional (O). 

Table 1 : Mapping of Operations 



Interface/Operations of the 
Alarm IRP Information Services 


GDMO Actions of 
CMIP Solution Set 


Qualifier 


AlarmlRPOperations 1/acknowledgeAlarms 


acknowledgeAlarms 


M 


AlarmlRPOperations 1/getAlarmList 


getAlarmList 


M 


AlarmlRPOperations 2/getAlarmCount 


getAlarmCount 





AlarmlRPOperations 3/unacknowledgeAlarms 


unacknowledgeAlarms 





AlarmlRPOperations 4/setComment 


setComment 





GenericlRPVersionOperation/getlRPVersion 


getAlarmlRPVersion 


M 


GenericlRPProfileOperation/getNotificationProfile 


getNotificationProfile 





GenericlRPProfileOperation/getOperationProfile 


getOperationProfile 






NOTE: the Interfaces GenericIRPVersionOperation and GenericIRPProfileOperation are defined in [1 1]. 



£75/ 



3GPP TS 32.111-4 version 4.0.0 Release 4 



12 



ETSI TS 132 111-4 V4.0.0 (2001-09) 



4.7.3 Mapping of Parameters of each operation 

The tables in the following clauses show the parameters of each operations defined in the IS 3GPP TS 32.1 1 1-2 [9] and 
their equivalents in this CMIP SS. 

The input parameters of the operations are mapped into "Action information" (see GDMO and ASN. 1 definitions for 
more details). 

The output parameters of the operations are mapped into "Action response" (see GDMO and ASN. 1 definitions for 
more details). 

Table 2: Mapping of parameters of 'acknowledgementAlarms' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalences 


Qualifier 


alarmlnformationReferenceList 


IN 


alarmReferenceList 


M 


ackUserld 


IN 


ackUserld 


M 


ackSystemId 


IN 


ackSystemId 





badAlarmlnformationReferenceList 


OUT 


errorAlarmReferenceList 


M 


status 


OUT 


status 


M 



Table 3: Mapping of Parameters of 'getAlarmCount' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalents 


Qualifier 


filter 


IN 


filter 





alarmAckState 


IN 


alarmAckState 





criticalCount 


OUT 


criticalCount 


M 


majorCount 


OUT 


majorCount 


M 


minorCount 


OUT 


minorCount 


M 


warningCount 


OUT 


warningCount 


M 


indeterminateCount 


OUT 


indeterminateCount 


M 


clearedCount 


OUT 


clearedCount 


M 


status 


OUT 


status 


M 



Table 4: Mapping of Parameters of 'getAlarmList' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalents 


Qualifier 


filter 


IN 


filter 





alarmAckState 


IN 


alarmAckState 





-- 




destination (input) - see note 1 


M 


alarmlnformationList 


OUT 


(sequence of alarm notifications) 
(see clause 4.5) 


M 


status 


OUT 


status 


M 


-- 




alignmentld (output) - see note 2 


M 


NOTE 1 : Destination is a CIVIIP specific parameter and is determined by the IVIanager. 
NOTE 2: Alignmentld is a CIVIIP specific parameter and is determined by the Agent. 



Table 5: Mapping of Parameters of 'getAlarmlRPVersion' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalents 


Qualifier 


versionNumberSet 


OUT 


versionNumberList 


M 


status 


OUT 


status 


M 
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Table 6: Mapping of Parameters of 'getOperationProfile' 



Operation parameters of the 
Information Services. 


IN/OUT 


CMIP Solution Set equivalences 


Qualifier 


irpVersion 


IN 


irpVersionNumber 


M 


operationNameProfile 


OUT 


operationNameProfile 


M 


operationParameterProfile 


OUT 


operationParameterProfile 


M 


status 


OUT 


status 


M 



Table 7: Mapping of Parameters of 'getNotificatioProfile' 



Operation parameters of the 
Information Services. 


IN/OUT 


CMIP Solution Set equivalences 


Qualifier 


irpVersion 


IN 


IrpVersionNumber 


M 


notificationNameProfile 


OUT 


notificationNameProfile 


M 


notificationParameterProfile 


OUT 


notificationParameterProfile 


M 


status 


OUT 


status 


M 



Table 8: Mapping of Parameters of 'setComment' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalents 


Qualifier 


alarm 1 nformation ReferenceLlst 


IN 


alarmReferenceList 


M 


commentUserld 


IN 


commentUserld 


M 


commentSystemId 


IN 


commentSystemId 





commentText 


IN 


commentText 


M 


badAlarminformationReferenceLlst 


OUT 


badAlarmReferenceLlst 


M 


Status 


OUT 


status 


M 



Table 9: Mapping of Parameters of 'unacknowledgeAlarms' 



Operation parameters of 
Information Services 


IN/OUT 


CMIP equivalents 


Qualifier 


alarmlnformationReferenceLlst 


IN 


alarmReferenceList 


M 


ackUserld 


IN 


ackUserld 


M 


ackSystemId 


IN 


ackSystemId 





badAlarmlnformationReferenceLlst 


OUT 


errorAlarmReferenceList 


M 


status 


OUT 


status 


M 



4.7.4 Mapping of Notifications 



Table 10 maps the Notifications defined in the Information Service of the Alarm IRP to the equivalent Notifications of 
the CMIP solution set for the Alarm IRP. The CMIP Notifications are qualified as Mandatory (M) or Optional (O). 



£75/ 



3GPP TS 32.111-4 version 4.0.0 Release 4 



14 



ETSI TS 132 111-4 V4.0.0 (2001-09) 



Table 10: Mapping of Notifications 



Notifications of Information 
Services of tlie Alarm IRP 


Equivalent Notifications of the CMIP 
solution set for the Alarm IRP 


Qualifier 


notifyNewAlarm 


environmentalAlarm ITU-T X.721 [4] 
equipmentAlarm ITU-T X.721 [4] 
qualityofServiceAlarm ITU-T X.721 [4] 
processingErrorAlarm ITU-T X.721 [4] 
communicationAlarm ITU-T X.721 [4] 


M 


notifyChangedAlarm 


environmentalAlarm ITU-T X.721 [4] 
equipmentAlarm ITU-T X.721 [4] 
qualityofServiceAlarm ITU-T X.721 [4] 
processingErrorAlarm ITU-T X.721 [4] 
communicationAlarm ITU-T X.721 [4] 





notifyClearedAlarm 


environmentalAlarm ITU-T X.721 [4] 
equipmentAlarm ITU-T X.721 [4] 
qualityofServiceAlarm ITU-T X.721 [4] 
processingErrorAlarm ITU-T X.721 [4] 
communicationAlarm ITU-T X.721 [4] 


M 


notifyAckStateChanged 


environmentalAlarm ITU-T X.721 [4] 
equipmentAlarm ITU-T X.721 [4] 
qualityofServiceAlarm ITU-T X.721 [4] 
processingErrorAlarm ITU-T X.721 [4] 
communicationAlarm ITU-T X.721 [4] 


M 


notifyAlarmListRebuilt 


alarmListRebuilt 


M 


notifyComments 


notifyComments 






4.7.5 Mapping of Parameters of each notification 

The notifications defined in [9] (Alarm IRP: Information Services) have a set of parameters that are common to all the 
notifications (see [10]: Notification IRP:CMIP Solution Set). Such common set of parameters are: 

ManagedObjectClass, ManagedObjectlnstance, EventTime, NotificationType, Notificationld. 

In the CMIP Solution Set, all the notifications originated within the Agent are reported to the Managers by means of the 
CMISE "M-EVENT-REPORT" primitive, which is implemented by means of the "m-EventReport OPERATION" (see 
[2] and[3]). The argument of m-EventReport OPERATION is defined in [3] as follows: 



EventReportArgument : : 

managedObject Class 
managedObject Instance 
eventTime 
eventType 
event Info 



SEQUENCE { 

Ob jectClass, 
Ob ject Instance, 

[5] IMPLICIT GeneralizedTime OPTIONAL, 
EventTypeld, 

[8] ANY DEFINED BY eventType OPTIONAL 



where eventinfo is further specified, for each specific notification, by means of specific GDMO/ASNl definitions. 

Therefore the first four parameters of the notification header are mapped to the first four fields of the 
EventReportArgument. The fifth parameter of the notification header is mapped to the eventinfo field of the 
EventReportArgument, together with all the other (not common) parameters of the notification. 

In the following tables, for the notifications defined in [9], all the parameters (but the common ones) are mapped to 
their corresponding elements of the CMIP SS notifications. 

The parameter SystemDN defined in [9] (Alarm IRP: Information Services) is not used in this CMIP Solution Set. 
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Table 1 1 : Mapping of Parameters of "notif yNewAlarm'" and "notifyCleared Alarm'" 



Notification parameters of 
Information Services 


CMIP Notification equivalences 


Qualifier 


notificationid 


notificationldentifier (note1) 


M 


probableCause 


probableCause 


M 


specificProblems 


specificProblems 





perceivedSeverity 


perceivedSeverity 


M 


backed UpStatus 


backedUpStatus 





backUpObject 


backUpObject 





trendlndication 


trendlndication 





thresholdlnfo 


thresholdlnfo 





correlatedNotifications 


correlatedNotifications 





stateChangeDefinition 


StateChangeDefinition 





monitoredAttributes 


monitoredAttributes 





proposedRepairActions 


proposedRepairActions 





additionalText 


additionalText 





alarmld 


- (note 2) 




NOTE 1 : notificationldentifier is a parameter of the Notification Header also defined in 3GPP TS 32.302. 
NOTE 2: In the CIVIIP Solution Set the alarmld is not used. In the CIVIIP Solution Set the alarm notifications 
are univocally identified by means of notificationldentifier and managedObjectlnstance. 


Table 12: Mapping of Parameters of 'notify AckStateChanged' 


Notification parameters of 
Information Services 


CMIP Notification equivalences 


Qualifier 


notificationid 


notificationldentifier (note1) 


M 


probableCause 


probableCause 


M 


specificProblems 


specificProblems 





perceivedSeverity 


perceivedSeverity 


M 


alarmld 


-- (note-2) 




acKTime 


additionallnformation 


M 


ackState 


M 


ackUserld 


M 


ackSystemId 





NOTE 1 : notificationldentifier is a parameter of the Notification Header also defined in 3GPP TS 32.302. 
NOTE 2: In the CMIP Solution Set the alarmld is not used. In the CIVIIP Solution Set the alarm notifications 
are univocally identified by means of notificationldentifier and managedObjectlnstance. 


Table 13: Mapping of Parameters of 'notify AlarmListRebuilt' 


Notification parameters of 
Information Services 


CMIP Notification equivalents 


Qualifier 


notificationid 


notificationldentifier (note) 


M 


reason 


reason 


M 


objectClass 


rebuiltObjectClass 


M 


objectlnstance 


rebuiltObjectlnstance 


M 


NOTE: notificationldentifier is a parameter of the Notification Header also defined in 3GPP TS 32.302. 
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Table 14: Mapping of Parameters of 'notifyComments' 



Notification parameters of 
Information Services 


CMIP Notification equivalents 


Qualifier 


notificationid 


notificationldentifier (notel) 


M 


objectClass 


alarmedObjectClass 


M 


objectlnstance 


alarmedObjectlnstance 


M 


notificationid 


notificationldentifier 


M 


eventTime 


alarmEventTime 


M 








notificationType 


eventType 


M 


alarmlype 


alarmType 


M 


probableCause 


alarmProbableCause 


M 


perceivedSeverity 


alarmPerceivedSeverity 


M 


comments 


comments 


M 


alarmld 


-- (note 2) 




NOTE 1 : notificationldentifier is a parameter of the Notification Header also defined in 3GPP TS 32.302. 
NOTE 2: In the CIVIIP Solution Set the alarmld is not used. In the CIVIIP Solution Set the alarm notifications 
are univocally identified by means of notificationldentifier and managedObjectlnstance. 



GDMO definitions 



5.1 IVIanaged Object Classes 
5.1.1 alarmControl 

This Managed Object Class (MOC) models the alarm information available within the Agent and significant for the 
NM-EM interface. It deals with both active and cleared but not yet acknowledged alarms. The NMC may initiate the 
transfer of current alarms according to the required parameters in the M- ACTION request 'getAlarmList'. 



alarmControl MANAGED OBJECT CLASS 
DERIVED FROM 

"Rec. X.721 I ISO/IEC 10165-2 
CHARACTERIZED BY 

alarmControlBasicPackage, 
alarmAcknowledgement Package, 
alarmlRPVerslonPackage; 



1992" :top; 



CONDITIONAL PACKAGES 

alarmCountPackage PRESENT IF "an instance supports it", 
alarmCommentPackage PRESENT IF "an instance supports it", 
alarmProf ilePackage PRESENT IF "an instance supports it", 
alarmUnacknowledgementPackage PRESENT IF "an instance supports it 
REGISTERED AS { ts32-lllAlarmOb jectClass 1}; 



5.2 Packages 

5.2.1 alarmControlBasicPackage 

alarmControlBasicPackage PACKAGE 
BEHAVIOUR 

alarmControlBasicPackageBehaviour; 

ATTRIBUTES 

alarmControlId GET, 

alarmsCountSummary GET; 

ACTIONS 



getAlarmList; 
NOTIFICATIONS 

alarmListRebuilt; 
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REGISTERED AS { ts32-lllAlarmPackage 1}; 

alarmControlBasicPackageBehaviour BEHAVIOUR 
DEFINED AS 

"The MOC alarmControl has been defined to provide information to the Manager about the currently 
alarms controlled by the Agent. 

An instance of the 'alarmControl' MOC is identified by the value of the attribute 'alarmControlW. 

The attribute 'alarmsCountSummary' provides a summary of the number of alarms managed in the 
Agent's alarm list (including the number of cleared but not yet acknowledged alarms). 

The action 'getAlarmList' is the means, for the Manager, to trigger an alarm alignment procedure in 
accordance with the parameter specified in the action request (this may be needed e.g. for first time 
alignment or after a link interruption between the Agent and the Manager). The alarm list is sent as a 
sequence of single alarm reports. 

The notification 'alarmListRebuilt' is sent by the Agent to the Manager to inform that the alarm list has 
changed. It is recommended that the Manager subsequently triggers an alarm alignment."; 



5.2.2 alarmCountPackage 



alarmCountPackage PACKAGE 
BEHAVIOUR 

alarmCountPackageBehaviour; 
ACTIONS 

getAlarmCount; 
REGISTERED AS { ts32-lllAlarmPackage 2}; 

alarmCountPackageBehaviour BEHAVIOUR 
DEFINED AS 

"This package has been defined to allow the Managers to get information from the Agent about the 
number of alarms currently present in the alarm list."; 

5.2.3 alarmAcknowledgementPackage 

alarmAcknowledgementPackage PACKAGE 
BEHAVIOUR 

alarmAcknowledgementPackageBehaviour; 
ACTIONS 

acknowledgeAlarms; 
NOTIFICATIONS 

"Rec. X.721 I ISO/IEC 10165-2 : 1992":communicationsAlarm, 
"Rec. X.721 I ISO/IEC 10165-2 : 1992":environmentalAlarm, 
"Rec. X.721 I ISO/IEC 10165-2 : 1 992" :equipment Alarm, 
"Rec. X.721 I ISO/IEC 10165-2 : 1992":processingErrorAlarm, 
"Rec. X.721 I ISO/IEC 10165-2 : 1 992" :qualityofService Alarm; 
REGISTERED AS { ts32-lllAlarmPackage 3}; 

alarmAcknowledgementPackageBehaviour BEHAVIOUR 
DEFINED AS 

"This package has been defined to provide information to the Manager about the acknowledgement status 
of the alarms controlled by the Agent. 

The action 'acknowledgeAlarms' allows the NM operator to acknowledge one or several alarms 
previously sent by the Agent as alarm notifications. 

The ITU-T Recommendation X.721 [4] compliant alarm notifications are sent by the Agent to the 
Manager to inform that one alarm has been acknowledged. The acknowledgement related information is 
carried in the additionallnformation attribute."; 
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5.2.4 alarmUnacknowledgementPackage 

alarmUnacknowledgementPackage PACKAGE 
BEHAVIOUR 

alarmUnacknowledgementPackageBehaviour; 
ACTIONS 

unac knowledge Alarms ; 
REGISTERED AS { ts32-lllAlarmPackage4}; 

alarmUnacknowledgementPackageBehaviour BEHAVIOUR 
DEFINED AS 

"This package has been defined to provide the Manager with the capability to unacknowledge alarms. 

The action 'unacknowledgeAlarms' allows the NM operator to unacknowledge one or several alarms 
previously acknowledged.by him. 

The ITU-T Recommendation X.721 [4] compliant alarm notifications are sent by the Agent to the 
Manager to inform that one alarm has been unacknowledged. The acknowledgement related information 
is carried in the additionallnformation attribute."; 

5.2.5 alarmCommentPackage 

alarmCommentPackage PACKAGE 
BEHAVIOUR 

alarmCommentPackageBehaviour; 
ACTIONS 

setComment; 
NOTIFICATIONS 

notifyComments; 
REGISTERED AS { ts32-lllAlarmPackage 5}; 

alarmCommentPackageBehaviour BEHAVIOUR 
DEFINED AS 

"This package has been defined to allow the Operators to write comments about alarms that are in the 
alarm list of the IRP Agent."; 

5.2.6 alarmlRPVersionPackage 

alarmlRPVersionPackage PACKAGE 
BEHAVIOUR 

alarmlRPVersionPackageBehaviour; 
ATTRIBUTES 

supportedAlarmlRPVersions GET; 

ACTIONS 

getAlar ml RP Version; 
REGISTERED AS { ts32-lllAlarmPackage 6}; 

alarmlRPVersionPackageBehaviour BEHAVIOUR 
DEFINED AS 

"This package has been defined to allow the Manager to get information about the Alarm IRP versions 
supported by the Agent. 

The attribute 'supportedAlarmlRPVersions' indicates all versions of the Alarm IRP currently supported by 
the Agent. 

The action 'getAlarmlRPVersion' may be invoked by the Manager to get information about the Alarm 
IRP versions supported by the Agent. Such Alarm IRP versions must compatible to each other. This 
means that the Manager may use any one of such Alarm IRP versions"; 
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5.2.7 alarmProfilePackage 

alarmProfilePackage PACKAGE 
BEHAVIOUR 

alarmProfilePackageBehaviour; 
ACTIONS 

getOperationProfile, 

getNotificationProfile; 

REGISTERED AS { ts32-lllAlarmPackage 7}; 

alarmProfilePackageBehaviour BEHAVIOUR 

DEFINED AS 

"This package has been defined to allow the Manager to get detailed information about the profile of Alarm 
IRP. 

The action 'getOperationProfile' is invoked by the Manager to get detailed information about the operations 
supported by Alarm IRP. 

The action 'getNotificationProfile' is invoked by the Manager to get detailed information about the 
notifications supported by Alarm IRP."; 

5.3 Actions 

5.3.1 acknowledgeAlarms (M) 

acknowledgeAlarms ACTION 
BEHAVIOUR 

acknowledgeAlarmsBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-lll-4TypeModule .AckOrUnack Alarms; 
WITH REPLY SYNTAX 

TS32-lll-4TypeModule .AckOrUnackAlarmsReply; 
REGISTERED AS { ts32-lllAlarmAction 1}; 

acknowledgeAlarmsBehaviour BEHAVIOUR 
DEFINED AS 

"This action is invoked by the Manager to indicate to the Agent that one or several alarms (previously 
sent by the Agent as alarm notifications) have to be acknowledged. In the action request the NM supplies 
the parameter ackUserld and ackSystemld. The other acknowledgement history parameters, i.e. alarm 
acknowledgement state (in this case acknowledged) and the acknowledgement time are set by the Agent 
itself 

The 'Action information' field contains the following data: 

• alarmReferenceList 

This parameter contains a set of MOI (Managed Object Instance) and notificationldentifier. Each pair 
identifies unambiguously in the scope of the Agent an alarm (previously received by the NM) that have to 
be now acknowledged. MOI can be absent if scope of uniqueness of notificationldentifier is across the 
IRPAgent. 

• ackUserld 

It contains the name of the operator who acknowledged the alarm or a generic name (dependent on the 
operational concept). It may have also the value NULL. 
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• ackSystemId 

It indicates the management system where the acknowledgment is triggered. It may have also the value 
NULL. 

The 'Action response' contains the following data: 

• status 

This parameter contains the results of the NM acknowledgement action. Possible values: no Error (0, all 
alarms found and ack state changed according to the manager request), ackPartlySuccessful (some alarms 
not found / not changeable, see next parameter), error (value indicates the reason why the complete 
operation failed). 

• errorAlarniReferenceList 

This parameter (significant only if status = ackPartlySuccessful) contains the list of moi (managed object 
instance) and notificationldentifier pairs of the alarms which could not be acknowledged and, for each 
alarm, also the reason of the error."; 



5.3.2 getAlarmCount (O) 



getAlarmCount ACTION 
BEHAVIOUR 

getAlarmCountBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-11 l-4TypeModule .GetAlarmCount; 
WITH REPLY SYNTAX 

TS32-lll-4TypeModule .GetAlarmCountReply; 
REGISTERED AS { ts32-ll lAlarmAction 2}; 

getAlarmCountBehaviour BEHAVIOUR 
DEFINED AS 

"The NM invokes this action to receive the number of available alarms in the Agent' alarm list according 
to the specification in the action request. The Manager may use this action to find out the number of 
alarms in the alarm list before invoking a synchronisation by means of the getAlarniList operation. The 
request is possible also before the Manager creates an own event forwarding discriminator instance within 
the Agent. 

The 'Action information' field contains the following data: 

• alarniAckState 

Depending on this optional parameter value, the NM gets the number of alarms of each perceivedSeverity 
value according to the following possible choices: 

all alarms 

all active alarms (acknowledged or not yet acknowledged) 

all active and acknowledged alarms 

all active and unacknowledged alarms 

all cleared and unacknowledged alarms. 

If the parameter is absent, all alarms from the Agent's alarm list are taken into consideration. 

• filter 

The handling of this optional parameter is as follows: 
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- if present and not NULL, it indicates a filter constraint which shall apply in the calculation of the results 

- if its value is NULL, no filter shall be considered and the Agent shall return the number of all alarms 
according to the value of the parameter alarniAckState (see above) 

- if absent, the handling depends on the availability of an event forwarding discriminator instance within 
the Agent. If this instance is valid, the filter construct of the event forwarding discriminator shall apply. If 
no EFD instance is available, the Agent shall return the number of all alarms according to the value of the 
above-mentioned parameter alarniAckState. 

The 'Action response' is composed of: 

• The numbers of alarms for each perceivedSeverity value (if applicable). 

• The parameter status containing the results of the NM action. Possible values: noError (0), error (the 
value indicates the reason of the error)."; 



5.3.3 getAlarmList (M) 



getAlarmList ACTION 
BEHAVIOUR 

getAlarmListBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-lll-4TypeModule .GetAlarmList; 
WITH REPLY SYNTAX 

TS32-lll-4TypeModule .GetAlarmListReply; 
REGISTERED AS { ts32-lllAlarmAction 3}; 

getAlarmListBehaviour BEHAVIOUR 
DEFINED AS 

"This action starts an alarm alignment procedure between a NM and Agent, which takes into account the 
acknowledgment state of the alarms and a dedicated filter (valid only for the current request). 

The 'Action information' field contains the following data: 

• alarniAckState 

Depending on this optional parameter value, the NM gets the alarm reports according to the following 
possible choices: 

all alarms 

all active alarms (acknowledged or not yet acknowledged) 

all active and acknowledged alarms 

all active and unacknowledged alarms 

all cleared and unacknowledged alarms. 

If the parameter is absent, all alarms from the Agent's alarm list are taken into consideration. 

• destination 

This parameter identifies the destination to which the alarm reports that have passed the test conditions 
specified in the parameter 'filter' are sent. According to ITU-T Recommendation X.721 [4], if no 
destination is specified in the request, then the discriminator is created with the destination defaulted to 
the AE-Title of the invoker. 

• filter 

The handling of this optional parameter (valid only for the current alignment request) is as follows: 
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- if present and not NULL, it indicates a filter constraint which shall apply in the forwarding of the 
alignment-related alarm reports 

- if its value is NULL, no real filter shall be considered and the Manager receives the alarms according to 
the value of the parameter alarniAckState (see above). 



The 'Action response' contains the following data: 

alignmentld 

The parameter is defined by the Agent and identifies unambiguously the current alarm alignment 
procedure. It allows the Manager to distinguish between alarm reports sent as consequence of several own 
alignment requests triggered in parallel. 

status 

The parameter contains the results of the NM action. Possible values: noError (0), error (the value 
indicates the reason of the error). 

After the action response is forwarded to the NM, the Agent sends the alarm list as a sequence of single 
alarm notifications in accordance with the values of the request parameters. Every alarm notification 
contains all fields of the alarm stored in the alarm list. In particular: 

The field additionalText contains at the beginning a string to allow a Manager to recognise that this 
alarm report is sent due to a previous getAlarniList request. The structure of this string is: 

'(ALIGNMENT-alignmentId)' for every alarm report except the last one or 

'(ALIGNMENTEND-alignmentId)' for the last alarm report sent by the Agent due to the current 
getAlarniList request. 

If available, the data related to the acknowledgment history (i.e. ackState, ackTime, ackUserld, 
ackSystemId) are provided in the field additionallnformation. 

Further details about the implementation of this operation are provided in the 'Introduction'."; 



5.3.4 setComment (M) 



setComment ACTION 
BEHAVIOUR 

setCommentBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-1 1 l-4TypeModule .SetComment; 
WITH REPLY SYNTAX 

TS32-1 1 l-4TypeModule .SetCommentReply; 
REGISTERED AS { ts32-lllAlarmAction4}; 

setCommentBehaviour BEHAVIOUR 
DEFINED AS 

"The NM invokes this action to associate a comment to one or more alarms. 

The 'Action information' field contains: 

• alarmReferenceList 

Contains a list of alarm identifiers to which the comment must be associated. 

• commentUserld 

Contains the identity of the User that invokes this operation. 
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• commentSystemId 

Contains the identity of the NM that invokes this operation. 

• commentText 

Contains the text of the comment. 

The 'Action response' is composed of the following data: 

• errorAlarmReferenceList 

List of pair of alarmld and failure reason. 

• status 

It contains the results of the NM action. Possible values: actionSucceeded (0), actionPartiallyFailed (12) 
or another value indicating the reason of the error."; 

5.3.5 getAlarm I RP Version (M) 

getAlarmlRPVersion ACTION 
BEHAVIOUR 

getAlarmlRPVersionBehaviour; 
MODE 

CONFIRMED; 
WITH REPLY SYNTAX 

TS32-lll-4TypeModule .GetAlarmlRPVersionReply; 
REGISTERED AS { ts32-lllAlarmAction5}; 

getAlarmlRPVersionBehaviour BEHAVIOUR 
DEFINED AS 

"The NM invokes this action to get information about the Alarm IRP versions supported by the Agent. 

The 'Action information' field contains no data. 

The 'Action response' is composed of the following data: 

• versionNumbersList 

It defines a list of Alarm IRP versions supported by the Agent. A list containing no element, i.e. a NULL 
list means that the concerned Agent doesn't support any version of the Notification IRP. 

• status 

It contains the results of the NM action. Possible values: noError (0), error (the value indicates the reason 
of the error)."; 



5.3.6 getNotificationProfile (O) 



getNotificationProfile ACTION 
BEHAVIOUR 

getNotificationProfileBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32- 111 -4TypeModule.IRPVersionNumber; 
WITH REPLY SYNTAX 

TS32- 111 -4TypeModule.GetNotificationProfileReply; 
REGISTERED AS { ts32-l 1 lAlarmAction 6}; 

getNotificationProfileBehaviour BEHAVIOUR 
DEFINED AS 
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"A Manager invokes this action to enquiry about the notification profile (supported notifications and supported 
parameters) for this specific Alarm IRP version. 

The 'Action information' contains the following data: 

• irpVersionNumber 

This mandatory parameter identifies the Alarm IRP version. 

The 'Action response' is composed of the following data: 

• notificationNameProfile 

It contains a list of notification names, i.e. a NULL list means that the Alarm IRP doesn't support any 
notification. 

• notificationParameterProfile. 

It contains a set of elements, each element corresponds to a notification name and is composed by a set of 
parameter names. 

• status 

It contains the results of this action. Possible values: noError (0), error (the value indicates the reason of the 
error)."; 



5.3.7 getOperationProfile (O) 



getOperationProfile ACTION 
BEHAVIOUR 

getOperationProfileBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-1 1 l-4TypeModule.IRPVersionNumber; 
WITH REPLY SYNTAX 

TS32-1 1 l-4TypeModule.GetOperationProfileReply; 
REGISTERED AS { ts32-l 1 lAlarmAction 7}; 

getOperationProfileBehaviour BEHAVIOUR 

DEFINED AS 

"A Manager invokes this action to enquiry about the operation profile (supported operations and supported 
parameters) for this specific Alarm IRP version. 

The 'Action information' contains the following data: 

• irpVersionNumber 

This mandatory parameter identifies the Alarm IRP version. 

The 'Action response' is composed of the following data: 

• operationNameProfile 

It contains a list of operation names. 

• operationParameterProfile. 

It contains a set of elements, each element corresponds to an operation name and is composed by a set of 
parameter names. 

status 

It contains the results of this action. Possible values: noError (0), error (the value indicates the reason of 

the error)."; 

5.3.8 unacknowledgeAlarms (O) 

unacknowledgeAlarms ACTION 
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BEHAVIOUR 

unacknowledgeAlarmsBehaviour; 
MODE 

CONFIRMED; 
WITH INFORMATION SYNTAX 

TS32-1 1 l-4TypeModule .AckOrUnack Alarms; 
WITH REPLY SYNTAX 

TS32-1 1 l-4TypeModule . AckOrUnack AlarmsReply; 
REGISTERED AS { ts32-lllAlarmAction 8}; 
unacknowledgeAlarmsBehaviour BEHAVIOUR 
DEFINED AS 

"This action is used by the Manager to indicate to the Agent that one or several alarms (previously 
acknowledged) have to be unacknowledged. Subsequently the 'acknowledgement history' information of 
these alarms in the Agent's alarm list is completely removed (this operation may be used by operators in 
case of a previous acknowledgement by mistake). 

The 'Action information' field contains the following data: 

alarmReferenceList 

This parameter contains a set of MOI (Managed Object Instance) and notificationldentifier pair. Each of 
them identifies unambiguously in the scope of the Agent an alarm (previously acknowledged by the NM) 
that have to be now unacknowledged. MOI can be absent if scope of uniqueness of notificationldentifier 
is across the IRP Agent. 

• ackUserld 

It contains the name of the operator who unacknowledged the alarm or a generic name (dependent on the 
operational concept). It may have also the value NULL. Note that only the user who previously 
acknowledged the alarm is allowed to unacknowledge it later. 

• ackSystemId 

It indicates the management system where the acknowledgment is triggered. It may have also the value 
NULL. Note that the unacknowledgement is allowed only at the management system where previously 
the acknowledgement took place. 

The 'Action response' contains the following data: 

• status 

This parameter contains the results of the NM unknowledgement action. Possible values: noError (0, all 
alarms found and ack state changed according to the manager request), unackPartlySuccessful (some 
alarms not found / not changeable, see next response parameter), error (value indicates the reason why the 
complete operation failed). 

• errorAlarmReferenceList 

This parameter (significant only if status = unackPartlySuccessful) contains the list of MOI (Managed 
Object Instance) and notificationldentifier pairs of the alarms which could not be unacknowledged and, 
for each alarm, also the reason of the error. MOI can be absent if scope of uniqueness of 
notificationldentifier is across the IRP Agent. "; 



5.4 Notifications 



5.4.1 alarmLlstRebuilt (IVI) 

alarmListRebuilt NOTIFICATION 
BEHAVIOUR 

alarmListRebuiltBehaviour; 
WITH INFORMATION SYNTAX 

TS32-1 ll-4TypeModule .AlarmListRebuiltlnfo; 
REGISTERED AS { ts32-lllAlarmNotification 11; 
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alarmListRebuiltBehaviour BEHAVIOUR 
DEFINED AS 

"This notification is used by the Agent to inform the NM that the alarm list has been rebuilt. 

The 'Event Information' field contains the following data: 

• notificationldentifier 

This ITU-T X.721 standardised parameter, together with MOI (Managed Object Instance), 
unambiguously identifies this notification. 

• rebuiltObjectClass 

This parameter carries the IRP Agent MOC when the entire AlarmList has been rebuilt. It carries a 
different MOC when the AlarmList has been partially rebuilt. 

• rebuiltObjectlnstance 

This parameter carries DN of the IRP Agent when the entire AlarmList has been rebuilt. It carries the DN 
of another MOI when the AlarmList has been pertially rebuilt and only the MOIs subordinate of this 
rebuilt MOI may be affected by this partial rebuilt. 



The parameter indicates the reason for alarm list rebuilding (if applicable)."; 



5.4.2 notifyComments (M) 



notifyComments NOTIFICATION 
BEHAVIOUR 

notifyCommentsBehaviour; 
WITH INFORMATION SYNTAX 

TS32-1 1 l-4TypeModule .NotifyComments; 
REGISTERED AS { ts32-lllAlarmNotification2}; 

notifyCommentsBehaviour BEHAVIOUR 
DEFINED AS 

"This notification is used by the Agent to inform the NM that one or more comments have been 
associated to one alarm. 

The 'Event Information' field contains the following data: 



alarmedObjectClass: 

alarmedObj ectlnstance : 

alarmEventTime : 

alarmType: 

alarmProbableCause: 

alarmPerceivedSeverity: 

comments: 



defined in ITU-T X.7 10 [2] andX.711[3] 

defined in ITU-T X.710 [2] and X.711[3] 

defined in ITU-T X.721 

the eventType of the alarm to which this comment is associated. 

defined in ITU-T X.721 

defined in ITU-T X.721 

the text of the comment. 
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5.5 Attributes 
5.5.1 alarmControlld 

alarmControlId ATTRIBUTE 

WITH ATTRIBUTE SYNTAX 

TS32-1 1 l-4TypeModule .GeneralObjectId; 
MATCHES FOR 

EQUALITY; 
BEHAVIOUR 

alarmControlIdBehaviour; 
REGISTERED AS { ts32-lllAlarmAttribute 1}; 

alarmControlIdBehaviour BEHAVIOUR 
DEFINED AS 

"This attribute names an instance of a 'alarmControl' object class."; 



5.5.2 alarmsCountSummary 



alarmsCountSummary ATTRIBUTE 
WITH ATTRIBUTE SYNTAX 

TS32-1 11 -4TypeModule .AlarmsCountSummary; 
MATCHES FOR 

EQUALITY; 
BEHAVIOUR 

alarmsCountSummaryBehaviour; 
REGISTERED AS { ts32-lllAlarmAttribute2}; 

alarmsCountSummaryBehaviour BEHAVIOUR 
DEFINED AS 

"This attribute indicates a summary of number of alarms managed in the Agent's alarm list sorted 
according to the perceived severity (including the number of cleared but not yet acknowledged alarms). 
Additionally the number of all currently active alarms is provided."; 



5.5.3 supportedAlarm I RP Versions 



supportedAlarmlRPVersions ATTRIBUTE 
WITH ATTRIBUTE SYNTAX 

TS32-lll-4TypeModule . SupportedAlarmlRPVersions; 
MATCHES FOR 

EQUALITY; 
BEHAVIOUR 

supportedAlarmlRPVersionsBehaviour; 
REGISTERED AS { ts32-lllAlarmAttribute 3}; 

supportedAlarmlRPVersionsBehaviour BEHAVIOUR 
DEFINED AS 

"This attribute provides the information concerning the Alarm IRP versions currently supported by the 
Agent."; 

5.6 Parameters 
5.6.1 ackStateParameter 

ackStateParameter PARAMETER 
CONTEXT 

TS32-lll-4TypeModule .Alarmlnfo.additionallnformation; 
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WITH SYNTAX 

TS32-lll-4TypeModule .AckState; 
BEHAVIOUR 

ackStateParameterBehaviour; 
REGISTERED AS { ts32-l 1 1 AlarmParameter 1 } ; 

ackStateParameterBehaviour BEHAVIOUR 
DEFINED AS 

"This parameter models the optional additionallnformation field of the alarm notification. If present, it 
informs the NM about the current acknowledgement state of the present alarm."; 



5.6.2 ackSystem Id Parameter 



ackSystemldParameter PARAMETER 
CONTEXT 

TS32-1 1 l-4TypeModule .Alarmlnfo. additionallnformation; 
WITH SYNTAX 

TS32-lll-4TypeModule .Systemid; 
BEHAVIOUR 

ackSystemldParameterBehaviour; 
REGISTERED AS { ts32-l 11 AlarmParameter 2}; 

ackSystemldParameterBehaviour BEHAVIOUR 
DEFINED AS 

"This parameter models the optional additionallnformation field of the alarm notification. If present, it 
informs the NM about the identifier of the management system where the present alarm has been 
acknowledged."; 

5.6.3 ackTimeParameter 

ackTimeParameter PARAMETER 
CONTEXT 

TS32-lll-4TypeModule .Alarmlnfo. additionallnformation; 
WITH SYNTAX 

TS32-lll-4TypeModule .AckTime; 
BEHAVIOUR 

ackXimeParameterBehaviour; 
REGISTERED AS { ts32-l 1 1 AlarmParameter 3 } ; 

ackXimeParameterBehaviour BEHAVIOUR 
DEFINED AS 

"Xhis parameter models the optional additionallnformation field of the alarm notification. If present, it informs 
the NM about the time the present alarm has been acknowledged by the Agent."; 

5.6.4 ackUserldParameter 

ackUserldParameter PARAMETER 
CONTEXT 

XS32-lll-4XypeModule .Alarmlnfo. additionallnformation; 
WITH SYNTAX 

XS32- 111 -4XypeModule.UserId; 
BEHAVIOUR 

ackUserldParameterBehaviour; 
REGISTERED AS { ts32-l 1 1 AlarmParameter 4} ; 

ackUserldParameterBehaviour BEHAVIOUR 
DEFINED AS 

"Xhis parameter models the optional additionallnformation field of the alarm notification. If present, it 
informs the NM about the identifier of the user who acknowledged the present alarm."; 
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ASN.1 definitions for Alarm IRP 



TS32-lll-4TypeModule {itu-t(O) identif ied-organization (4) etsi(O) mobileDomain (0) umts-Operation- 
Maintenance (3) ts-32-111 (111) part4(4) informationModel (0) asnlModule (2) versionl(l)} 

DEFINITIONS IMPLICIT TAGS ::= 

BEGIN 

— EXPORTS everything 

IMPORTS 

Notif icationldentif ier. Destination, EventTime, ProbableCause, PerceivedSeverity 
FROM Attribute-ASNlModule { joint-iso-ccitt ms(9) smi(3) part2(2) asnlModule (2 ) 1} 

Alarmlnf o 

FROM Notification-ASNlModule (joint-iso-ccitt ms(9) smi(3) part2(2) asnlModule (2) 2} 

CMISFilter, Ob ject Instance, ObjectClass, EventTypeld 

FROM CMIP-1 (joint-iso-ccitt ms(9) cmip ( 1 ) modules (0) protocol (3) } ; 

baseNodeUMTS OBJECT IDENTIFIER ::= ( itu-t (0) identif ied-organization (4) etsi (0) mobileDomain 
(0) 

umts-Operation-Maintenance (3) } 

ts32-lllPrefix OBJECT IDENTIFIER ::= ( baseNodeUMTS ts-32-111 ( 111 ) } 

ts32-lllPart4 OBJECT IDENTIFIER ::= ( ts32-lllPref ix part4(4)} 

ts32-lll-4InfoModel OBJECT IDENTIFIER ::= ( ts32-lllPart4 inf ormationModel ( ) } 

ts32-lllAlarmObjectClass OBJECT IDENTIFIER ::= ( ts32-lll-4Inf oModel managedOb jectClass (3 ) } 

ts32-lllAlarmPackage OBJECT IDENTIFIER ::= ( ts32-lll-4Inf oModel package (4)} 

ts32-lllAlarmParameter OBJECT IDENTIFIER ::= ( ts32-lll-4InfoModel parameter (5) } 

ts32-lllAlarmAttribute OBJECT IDENTIFIER ::= ( ts32-lll-4Inf oModel attribute (7 ) } 

ts32-lllAlarmAction OBJECT IDENTIFIER ::= ( ts32-lll-4Inf oModel action (9)} 

ts32-lllAlarmNotification OBJECT IDENTIFIER ::= ( ts32-lll-4Inf oModel action (10)} 



— Start of 3GPP SA5 own definitions 
AckErrorList ::= SET OF Errorlnfo 
AlarmRef erence : : = SEQUENCE 
( 

moi Ob ject Instance OPTIONAL, — absent if scope of uniquness of notif icationid is across IRPAgent 
notificationldentifier Notificationldentifier 
} 
AckOrUnackAlarms : : = SEQUENCE 

( 

alarmReferenceList SET OF AlarmRef erence, ITU— T X.721 

ackUserld Userld, 

ackSystemId Systemid OPTIONAL 

} 
AckOrUnackAlarmsReply : : = SEQUENCE 

( 

status ErrorCauses, 

errorAlarmRef erenceList AckErrorList 

} 
AckState : : = ENUMERATED 

( 

acknowledged (0), 

unacknowledged (1) 
} 

AckTime ::= GeneralizedTime 
AlarmChoice : : = ENUMERATED 

( 

allAlarms (0), 

allActiveAlarms (1), 

allActiveAndAckAlarms (2) , 

allActiveAndUnackAlarms (3) , 

allClearedAndUnackAlarms (4) 
} 
AlarmsCountSummary : : = SEQUENCE 

( 

activeAlarmsCount INTEGER, — this is the sum of criticalCount, majorCount, 

minorCount, warningCount 



— and indeterminateCount 



criticalCount INTEGER, 

majorCount INTEGER, 
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minorCount INTEGER, 

warningCount INTEGER, 

indeterminateCount INTEGER, 

clearedCount INTEGER 

} 
AlarmListRebuiltlnfo ::= SEQUENCE 

{ 

notificationldentifier Notif icationldentif ier, — ITU-T X.721 

rebuiltOb jectClass ObjectClass, 

rebuiltObject Instance Ob ject Instance, 

reason ErrorCauses 

} 
Comment ::= GraphicString 
ErrorCauses : : = ENUMERATED 
{ 

noError (0), — operation / notification successfully performed 
wrongFilter (1), — the value of the filter parameter is not valid 

wrongAlarmAckState (2), — the value of the alarmAckState parameter (e.g. getAlarmCount ) is not 
valid 

ackPartlySuccessful (3), — acknowledgment request partly successful 
unackPartlySuccessful (4), — unacknowledgment request partly successful 

wrongAlarmRef erence (5), — alarm identifier used in the alarm reference list not found (e.g. in 
case of acknowledgement request) 
wrongAlarmRef erenceList (6), — the alarm reference list (e.g. in case of acknowledgement 

request) is empty or completely wrong 
alarmAlreadyAck (7), — alarm to be acknowledged is already in this state 
alarmAlreadyUnack (8), — alarm to be acknowledged is already in this state 

wrongUserld (9), — the user identifier in the unacknowledgement operation is not the same as 
in the previous acknowledgementAlarms request 

wrongSystemId (10), — the system identifier in the unacknowledgement operation is not the same as 
in the previous acknowledgementAlarms request 

alarmAckNotAllowed (11), — current management system not allowed to acknowledge the alarm (e.g. 
due to acknowledgement competence rules) 

setCommentPartlySuccessful (12), — the setComment action partly successful (e.g. some alarmld 
are not in the alarmList) 

unspecif ledErrorReason (255) — operation failed, specific error unknown 
} 
Errorinf o : : = SEQUENCE 

{ 

moi Ob ject Instance OPTIONAL, — absent if uniqueness of notificationldentifier is across 
IRPAgent 

notificationldentifier Notificationldentifier, — ITU-T X.721 

reason ErrorCauses 

} 
GeneralObjectId ::= INTEGER 
GetAlarmCount : : = SEQUENCE 

{ 

alarmAckState AlarmChoice OPTIONAL, 

filter CMISFilter OPTIONAL — ITU-T X.711 

} 
GetAlarmCountReply : : = SEQUENCE 

{ 

criticalCount INTEGER, 

majorCount INTEGER, 

minorCount INTEGER, 

warningCount INTEGER, 

indeterminateCount INTEGER, 

clearedCount INTEGER, 

status ErrorCauses 

} 
GetAlarmlRPVersionReply : : = SEQUENCE 

{ 

versionNumberList SupportedAlarmIRP Vers ions, 

status ErrorCauses 

} 
GetAlarmList : : = SEQUENCE 

{ 

alarmAckState AlarmChoice OPTIONAL, 

destination Destination, — ITU-T X.721 

filter CMISFilter OPTIONAL — ITU-T X.711 

} 
GetAlarmListReply : : = SEQUENCE 

{ 

alignmentld INTEGER, 

status ErrorCauses 

} 
GetNotif icationProf ileReply : : = SEQUENCE 
{ 
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notif icationNameProf ile 
notif icationParameterProf ile 
status 
) 

GetOperationProfileReply 



Notif icationLi St, 
Parameter Li St Of Li St, 

ErrorCauses 



{ 

operationNameProf ile 
operationParameterProf ile 
status 
} 



SEQUENCE 

OperationList, 
ParameterListOf List , 
ErrorCauses 



IRPVersionNumber : 
Notif icationList 
NotificationName : 



Graphic St ring 

SET OF NotificationName 

Graphic St ring 



NotifyComments : : = SEQUENCE 
{ 

alarmedObject Class 
alarmedObject Instance 
alarmE vent Time 
alarmType 

alarmProbableCause 
alarmPerceivedSe verity 
comments 

} 



Ob jectClass, 

Ob ject Instance, 

EventTime, 

EventTypeld, 

ProbableCause, 

PerceivedSeverity, 

SET OF Comment 



OperationList 
OperationName 
ParameterList 



SET OF OperationName 

Graphic St ring 

SET OF ParameterName 

ParameterListOfList ::= SET OF ParameterList 

ParameterName ::= GraphicString 



SetComment 



SEQUENCE 



alarmReferenceList SET OF AlarmRef erence, 
commentUserld Userld, 

commentSystemId Systemid, 
commentText Comment 



SetCommentReply 



SEQUENCE 



badAlarmRef erenceList 
status 
} 
Systemid ;:= GraphicString 



SET OF Errorlnfo, 
ErrorCauses 



SupportedAlarmlRPVersions ::= SET OF IRPVersionNumber 
Userld ::= GraphicString 

END — of module TS32-lll-4TypeModule 



£75/ 



3GPP TS 32.111-4 version 4.0.0 Release 4 



32 



ETSI TS 132 111-4 V4.0.0 (2001-09) 



Annex A (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


Mar 2000 


S_07 


SP-000012 


-- 


-- 


Approved at TSG SA #7 and placed under Change Control 


2.0.0 


3.0.0 


Mar 2000 


- 


-- 


-- 


— 


cosmetic 


3.0.0 


3.0.1 


Jun 2000 


S_08 


SP-000254 


005 


-- 


Split of TS - Part 4: Alarm Integration Reference Point (IRP): CMIP 
Solution Set (SS) 


3.0.1 


3.1.0 


Sep 2000 


-- 


-- 


— 


— 


cosmetic 


3.1.0 


3.1.1 


Jun 2001 


S_12 


SP-010282 


001 


-- 


Alarm IRP: CMIP SS Rel4 - Addition of feature. As SA5 hiad not 
reviewed this part, It Is submitted to SA#12 for Information only. 


3.1.1 


- 


Sep 2001 


S 13 


SP-010470 


001 


1 


Addition of features 


3.1.1 


4.0.0 
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